Deletes a message queue.

OSStatus MPDeleteQueue (
    MPQueueID queue
);

queue

The ID of the message queue you want to delete.

function result

A result code.

DISCUSSION

After calling MPDeleteQueue, the specified queue ID becomes invalid, and all internal resources associated with the queue (including queued messages) are reclaimed. Any tasks waiting on the queue are unblocked and their respective MPWaitOnQueue calls will return with the result code kMPDeletedErr.

Also see the function MPCreateQueue.

VERSION NOTES

Introduced with Multiprocessing Services 1.0.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MPLibrary 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by MPLibrary 1.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)